//----------------------------------------------------------------------------------------------//
//												//
//	Que tipo de programa é este?								//
//												//
//----------------------------------------------------------------------------------------------//

Este programa pertence ao tipo de indicadores com IA treinável.
A IA integrada é treinável, ou seja, sem treino prévio, não tem parâmetros e simplesmente não arranca.
Se recebeu uma versão de demonstração limitada que não esteja na loja MQL5.com, após o download,
coloque o ficheiro manualmente na pasta "Indicadores" do terminal.


//----------------------------------------------------------------------------------------------//
//												//
//	Para que serve?										//
//												//
//----------------------------------------------------------------------------------------------//

Este indicador utiliza uma IA treinável para prever o comportamento futuro dos preços:

- 10 dias à frente,
- 1,7 dias à frente,
- 5 horas à frente,
- 50 minutos à frente,
- 10 minutos à frente.

Informações adicionais são também aqui fornecidas sob a forma de:
- o desvio de preço previsto em pontos e,
- o erro previsto em percentagem (se este valor exceder 50%,
o programa emitirá um aviso).

Este programa possui uma IA treinável integrada, ou seja, antes de o utilizar,
deve ser treinado com novos dados de entrada.


//----------------------------------------------------------------------------------------------//
//												//
//Como obtenho o ficheiro de dados de entrada para treinar as redes neuronais correspondentes?	//
//												//
//----------------------------------------------------------------------------------------------//

A forma de o fazer está descrita nas instruções correspondentes utilizando o "Utilitário de Aprendizagem de IA".
O utilitário de aprendizagem de IA é gratuito e pode ser descarregado manualmente
na página principal do produto no site do MQL5.


//----------------------------------------------------------------------------------------------//
//												//
//	Descrição das opções de menu deste programa.						//
//												//
//----------------------------------------------------------------------------------------------//

Existem aqui apenas dois parâmetros:

- 1) "Mostrar Comentário" - activa/desactiva a apresentação de comentários na janela onde este programa está a ser executado.
Isto é necessário se planeia utilizar este indicador no seu programa MQL5 e, em seguida,
se necessário, este parâmetro pode ser desativado.
- 2) "Desvio" - habilita/desabilita a apresentação do desvio previsto do valor previsto
expresso em pontos.


//----------------------------------------------------------------------------------------------//
//												//
//	Testando a versão de demonstração deste programa.					//
//												//
//----------------------------------------------------------------------------------------------//

Antes de testar, precisa de treinar a IA integrada, caso isso ainda não tenha sido feito.
A versão de demonstração gratuita deste programa, que funciona apenas no testador de estratégias, é limitada
pelo que os comentários sobre os valores previstos só serão apresentados até
o início de agosto de 2025. Assim, para testes gratuitos, utilize o período
anterior a essa data.
Aqui, é melhor utilizar o modo de teste "OHLC em M1" para a aceleração, uma vez que o indicador
calcula os seus novos valores apenas no momento da abertura de novas velas.


//----------------------------------------------------------------------------------------------//
//												//
//	Utilizando este indicador no seu programa MQL5.						//
//												//
//----------------------------------------------------------------------------------------------//

Este indicador possui 3 buffers de valor que podem ser utilizados:

a) "Buffer 0" - contém informação sobre o preço previsto, onde existem apenas 5 valores:

0) - 10 dias à frente,
1) - 1,7 dias à frente,
2) - 5 horas à frente,
3) - 50 minutos à frente,
4) - 10 minutos à frente.

b) "Buffer 1" - contém informação sobre o desvio previsto
sob a forma - (desvio em pontos) * (o valor de um ponto de preço),
onde existem apenas 5 valores:

0) - 10 dias à frente,
1) - 1,7 dias à frente,
2) - 5 horas à frente,
3) - 50 minutos à frente,
4) - 10 minutos à frente.

c) "2 Buffer" - contém informação sobre o erro previsto
no formato - (erro em percentagem)/100, ou seja, valores de 0 a 1,
onde existem apenas 5 valores:

0) - 10 dias à frente,
1) - 1,7 dias à frente,
2) - 5 horas à frente,
3) - 50 minutos à frente,
4) - 10 minutos à frente.


//----------------------------------------------------------------------------------------------//
//												//
//	Recursos de utilização deste programa.							//
//												//
//----------------------------------------------------------------------------------------------//

Embora o "AI Learn Utility" utilize OpenCL e exija um dispositivo apropriado, o programa indicador autónomo realiza todos os cálculos na CPU e não necessita de suporte OpenCL.

Requisitos mínimos de hardware:

- 20 GB de espaço livre no disco rígido,
- 4 GB de placa gráfica com suporte OpenCL,
- 16 GB de RAM.

ATENÇÃO: - Os ficheiros de parâmetros de IA para cada símbolo ocupam aproximadamente 1 GB.

Este programa utiliza muitos ficheiros com parâmetros de rede neural da
pasta "//Common//Files//SolarTradeSuite//Theia//...", pelo que provavelmente existem limitações
funcionar no testador de estratégias e no VPS.

O teste de estratégias e a otimização com este indicador provavelmente só podem ser realizados localmente ou
é impossível utilizar um cluster de agentes numa rede local ou
é impossível utilizar uma rede na nuvem MQL5.

O teste de estratégias e a otimização de consultores, bem como o número de programas em execução simultânea fora do testador de estratégias, são também possivelmente limitados pelo número de ficheiros abertos em simultâneo, que é aproximadamente igual a 160 agentes locais e está descrito em detalhe na documentação técnica do MQL5.

As mesmas limitações para o VPS: Este indicador não foi testado quanto à possibilidade de funcionar em VPS. Devido ao grande número de ficheiros com parâmetros de IA, pode não funcionar.

Antes de começar, certifique-se de que pelo menos 108 velas do período "MN1" ou 10 anos estão disponíveis a partir do momento do início deste programa. Isto é necessário porque a IA integrada utiliza o histórico de preços dos últimos 9 anos como dados de entrada para fazer uma previsão.

Fora do testador de estratégias, este programa pode ser executado em qualquer período, ou seja, o período da janela em que o programa é iniciado fora do testador de estratégias não tem qualquer importância.

Ao lançar um símbolo não utilizado pela primeira vez, deve primeiro treinar a IA — a forma de o fazer está descrita nas instruções correspondentes utilizando o "AI Learn Utility".
Recomenda-se a utilização do "AI Learn Utility" com a maior frequência possível, mas
aproximadamente um ou dois anos após a última utilização ou
se tiver decorrido um longo período de tempo desde o último treino,
ou se observar alterações significativas no comportamento do preço do símbolo utilizado.

Lembre-se: "!!! ATENÇÃO: Esta IA pode cometer erros — certifique-se de verificar as suas previsões para garantir a exatidão!!!".
O cálculo do erro e a própria previsão são feitos através de métodos avançados de matemática,
análise estatística e aprendizagem automática, mas o preço de um instrumento financeiro pode ser afetado por
outros eventos não considerados por estes métodos, tais como intenções políticas, eventos ambientais, condições meteorológicas, etc.

Todos os parâmetros da IA são guardados no disco rígido na pasta do terminal "//Common//Files//SolarTradeSuite//Theia//...". Se tiver um link para descarregar parâmetros prontos para IA, após o download, copie-os para lá.

Não se esqueça de fazer manualmente uma cópia de segurança dos parâmetros de IA numa pasta separada criada por si.


//----------------------------------------------------------------------------------------------//
//												//
//	Perguntas adicionais.									//
//												//
//----------------------------------------------------------------------------------------------//

O utilitário de formação de IA é gratuito e pode ser descarregado manualmente na
página principal do produto no site MQL5.
Todas as instruções estão disponíveis e podem ser descarregadas manualmente na
página principal do produto no site MQL5. Leia todas as instruções e o
ficheiro de licença com atenção antes de colocar qualquer questão.

1) Sinta-se à vontade para colocar questões no separador de discussão na página do indicador correspondente no site MQL5.com.

2) E-mail para comunicação: gerasimovadam@gmail.com, tgwls2@gmail.com.